home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / cat.arc / CAT.DOC < prev   
Encoding:
Text File  |  1986-11-25  |  13.5 KB  |  333 lines
  1.  
  2.  
  3.                                                                                 
  4.                                                                                 
  5.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  6.  
  7.  
  8.  
  9.                                                                                 
  10.  
  11.  
  12.  
  13.        CONTENTS
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.        Overview . . . . . . . . . . . . . . . . . . . . . . . . 1
  23.  
  24.  
  25.        Using CAT. . . . . . . . . . . . . . . . . . . . . . . . 2
  26.  
  27.  
  28.        Invoking CAT . . . . . . . . . . . . . . . . . . . . . . 2
  29.  
  30.  
  31.          Background . . . . . . . . . . . . . . . . . . . . . . 2
  32.  
  33.  
  34.            Screen Format. . . . . . . . . . . . . . . . . . . . 3
  35.  
  36.  
  37.            Manipulating the Display . . . . . . . . . . . . . . 4
  38.  
  39.  
  40.            Program Function Keys. . . . . . . . . . . . . . . . 5
  41.  
  42.  
  43.            Internal CAT Functions . . . . . . . . . . . . . . . 6
  44.  
  45.  
  46.            Using the Command area . . . . . . . . . . . . . . . 6
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                                                                 
  57.                                                                                 
  58.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  59.  
  60.                                                                                 
  61.        OVERVIEW
  62.  
  63.  
  64.  
  65.        This  document  provides information about CAT for use on the IBM
  66.        Personal Computer.  We hope the program fills  as  many  of  your
  67.        needs  as  it  did  ours.   After all, that is the reason we have
  68.        developed this integrated package.  The better tools you have  to
  69.        work with the better the end result.
  70.  
  71.        It  provides  a  full  screen list of a file set specified by the
  72.        user.  These may be presented in an  unsorted,  name,  extension,
  73.        date,  or size order, and the sorted order of presentation may be
  74.        changed dynamically.  Within each entry is displayed an  area  to
  75.        allow  the  entry  of commands.  This command area may be used to
  76.        issue commands which  pertain  to  the  files  displayed.   These
  77.        commands  are  entered in the command areas adjacent to the files
  78.        they are to affect.  Helpful facilities are  provided  to  lessen
  79.        the  typing required.  One example is the use of the "=" internal
  80.        command to repeat the last command.  To provide  additional  ease
  81.        of  use,  the  editing keys and function keys may be used to page
  82.        through the list and add or delete commands.
  83.  
  84.        When all desired commands have been entered, the user enters exec
  85.        execution  mode  to  pass the commands entered in display mode to
  86.        the PCDOS command environment.  The commands are  passed  to  the
  87.        command  environment for execution one after the other, befinning
  88.        with the command closest to the top of the  list  and  continuing
  89.        toward  the end of the list until all commands have been returned
  90.        or an internal function is encountered.  If no  internal  command
  91.        is encountered, the DOS prompt appears, with a full block cursor.
  92.        Entry of a null command (i.e.  return)  will  redisplay  the  the
  93.        file  list.  Any other entry will be immediately executed by DOS.
  94.        The DOS prompt is displayed to allow you  to  view  any  messages
  95.        which were put on the display by the executed commands.
  96.  
  97.        The  program  becomes  a  resident  extension of DOS in core.  It
  98.        occupies  approximately  7k  bytes  of  stroage.   This   storage
  99.        includes  the  necessary  resident  code  and  table space for an
  100.        unlimited amount of entries. Cat will remain active in core until
  101.        the system is rebooted.
  102.        BACKGROUND:
  103.        CAT is invoked from the DOS command environment by issuing the
  104.        command: A>cat      (refer to figure 1)
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  116.  
  117.        If the filespec is omitted, all files on the current default disk
  118.        will be listed.  If CAT is used on the IBM PC/XT only those files
  119.        within the current directory are listed.  If you specify /sn then
  120.        the  files  will be listed in alphabetical order of the filename.
  121.        If you specify /se then the files will be listed in  alphabetical
  122.        order  of  the  filename  extension.  If you specify /sd then the
  123.        files will be listed in date sequence.  The very  first  will  be
  124.        the  most  recent  entry and the last file in the listing will be
  125.        the oldest file entered.  If you specify /ss the  files  will  be
  126.        listed  by  size.   The  largest  file  first  contiuning  to the
  127.        smallest file.
  128.  
  129.  
  130.        ╔══════════════════════════════════════════════════════════════╗
  131.        ║                                                              ║
  132.        ║ CAT < fspec > < /sn | /se | /sd | /ss |  < /? >              ║
  133.        ║                                                              ║
  134.        ║ other available options are described on the intial screen   ║
  135.        ║                                                              ║
  136.        ║ If no parameter is specified the files will be listed by date║
  137.        ║                                                              ║
  138.        ╚══════════════════════════════════════════════════════════════╝
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.        SCREEN FORMAT:
  148.        The displayed format consists fo three distinct areas.  The first
  149.        line is a status line.  The dirst  two  characters  are  the  DOS
  150.        prompt  currently active.  The balance of the line gives the size
  151.        of the  allocation  unit,  the  allocation  units  used  and  the
  152.        allocation  units  free  (as  well  as  the  percentage  of  free
  153.        allocation  units)  on the listed diskette plus the number of the
  154.        first displayed entry as well as the count of active  (displayed)
  155.        entries.
  156.  
  157.        The  next  23  lines  contain displayed entries for listed files.
  158.        The first portion gives the filespec for the  listed  file.   The
  159.        next  25  postions  are  a command area.  The balance of the line
  160.        contains the attribute  indicators,  the  size  of  the  file  in
  161.        decimal  bytes,  the  number  of allocation units occupied by the
  162.        file, followed by the date and time the file was last updated.
  163.  
  164.        The last line of the screen displays the function key settings.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  172.  
  173.        Manipulating the display.
  174.  
  175.        Once the list is displayed, the editing keys on the keyboard  may
  176.        be  used  to  manipulate  the  screen.  The semantics for the key
  177.        useage follow those used for the BASIC editor.  They are:
  178.  
  179.  
  180.        PgUp    move the display to show entries nearer the beginning of
  181.         the entry sequence.
  182.  
  183.        Ctrl-PgUp move the display to  show  the  first screen of entries
  184.                  in the entry sequence.
  185.  
  186.        PgDn     move the display to  show  entries nearer the end of the
  187.                 entry sequence.
  188.  
  189.        Ctrl-PgDn move the  display  to  show  the last screen of entries
  190.                  in the entry sequence.
  191.  
  192.        Home     position  the cursor to the first postion of the command
  193.                 area on the first entry displayed on the screen.
  194.  
  195.        End      position the cursor at the last character in the command
  196.                 field on the line containing the cursor.
  197.  
  198.        Ctrl-End erase the command area from the cursor to the end of the
  199.                 field.
  200.  
  201.  
  202.  
  203.        Ins      toggle insert mode. When in insert mode, a full block
  204.                 cursor is displayed.
  205.  
  206.        Del      delete the character at the cursor.
  207.  
  208.        Cursor keys move the cursor  in  the  directions depicted  by the
  209.                 arrows.  If the  cursor movement is up or down  and  the
  210.                 movement would   result in moving onto the first or last
  211.                 line of the screen and thefile is not already positioned
  212.         with the first or last entry on the top or bottom  line,
  213.             the screen will be scrolle up or down.
  214.  
  215.        Enter    positions  the  cursor  to  the  beginning  of  the next
  216.         command area. If appropriate, the screen will be scroll-
  217.         ed as described below in the entry for Tab.
  218.  
  219.        backspace deletes the character to the left of the cursor.
  220.  
  221.        Tab        skips  to  the  first  position of the next command area
  222.                 unless the skip is off the last entry displayed. In this
  223.              case, scrolling occurs as for down  cursor  unless  pro-
  224.         hibited by file position.  In  this case, wrap to  first
  225.         displayed command area occurs.
  226.  
  227.  
  228.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  229.  
  230.        Shift-Tab skips backward to the beginning of the previous command
  231.                  field.  If the cursor is not in the first  position  of
  232.          the command area, this key will position to  the  first
  233.          position of the current command area.  If the  skip  is
  234.          off  the first entry displayed, scrolling occurs as for
  235.               up cursor unless prohibited by file  position.  In this
  236.          case, wrap to last displayed command area occurs.
  237.  
  238.  
  239.  
  240.        ESC     clear the command area to blanks then position the cursor
  241.            to the first position of the command area on the  current
  242.            entry.
  243.  
  244.        Ctrl-Return enter the execution mode.
  245.             [CR]
  246.  
  247.  
  248.        While  in  execution  mode a block cursor will be displayed along
  249.        with the DOS prompt, CAT  remains  active  in  core  and  can  be
  250.        recalled  simply  be  depressing  [CR].   CAT  will  display  the
  251.        previous entries from your previous session.  Simply depress [F1]
  252.        to refresh and update the current display.
  253.  
  254.        Program Function Keys
  255.  
  256.  
  257.        The  functions  provided on the PF keys are displayed on the 25th
  258.        line of the display.  The assignment  is  similar  to  the  BASIC
  259.        softkeys,  with  the  function key placing the assigned character
  260.        string on the command line at the first position,  then  entering
  261.        execution mode.  The function key assignments are as following:
  262.  
  263.        [F1] SUBMIT-update display with all entries in current directory.
  264.        [F2] XCLUDE-exclude entry where cursor is positioned until the
  265.                    display is re-SUBMIT-ed.
  266.        [F3] READ=C-read and display entries from drive C: in current dir
  267.        [F4] READ=A-read and display entries form the floppy diskette.
  268.        [F5] SRTNAM-sort(ascending) on name and update display.
  269.        [F6] SRTEXT-sort(ascending) on extension and update display.
  270.        [F7] SRTDTE-sort on date(most recent displayed first) and update.
  271.        [F8] SRTSIZ-sort on size(largest displayed first) and update.
  272.        [F9] EDIT  -executes IBM professional editor.*
  273.        [F0] SCAN  -executes SCAN.COM(allows you to browse your text or
  274.                    programs, no changes allowed just checking activity)
  275.                    Once in SCAN you may end the session by depressing
  276.                    the [ESC].
  277.  
  278.  
  279.  
  280.  
  281.  
  282.       CAT.COM   -    DIRECTORY MAINTENANCE FACILITIES
  283.  
  284.        *-Send us your copy of CAT along with a check for $10.00 to cover
  285.        postage and handling and we will change the  PF  key  setting  to
  286.        execute  your  preferred editor.e.g.-WS(wordstar),VW(volkswriter)
  287.        EDLIN(editor on DOS diskette) or your personal preference.   Make
  288.        sure to include a note stating your requirements.
  289.  
  290.        Using the Command area:
  291.  
  292.        The  input  areas  after  the  fileids  may  be used to enter any
  293.        command as in the  normal  DOS  environment.   If  not  otherwise
  294.        directed,  CAT  will append the complete filespec associated with
  295.        the command area at the end of the command line.  If the  command
  296.        is  preceded  by the /O internal command, no appending will occur
  297.        and the command will be passed to the command environment without
  298.        further  processing.   The  /n internal command will allow you to
  299.        execute the current filespec.  As  noted  earlier  the  "="  will
  300.        allow you to repeat your command without having to retype it. To
  301.        copy a particular file to the A:drive use the following format
  302.        on the command line: COPY / A:-this will copy the file to drive
  303.        A. The "/" causes cat to insert the filespec located on the same
  304.        line  as  you  are  entering the command.  If you need to sort on
  305.        particular filenames then enter the following:  /r *.mem
  306.  
  307.        Then press the [Ctrl] and [CR].  The block cursor will show along
  308.        with the DOS prompt, just press [CR] for your requested list.
  309.  
  310.        Additional commands which may prove to be very valuable are HIDE,
  311.        EXPOSE and PROTECT.  Type the command  HIDE  on  the  line  of  a
  312.        filespec  you  wish  to  conceal  from prying eyes.  Then depress
  313.        [Ctrl]-[CR] to hide the file from most normal directory searches.
  314.        Press  [CR] to return to the CAT display and press [F1] to update
  315.        the display.  You will notice the capital H displayed on line  of
  316.        the  filespec  you  specified to hide.  Use the command EXPOSE to
  317.        reveal  the  hidden  file.   PROTECT  will  protect  a  file from
  318.        accidental erasure.  Use the EXPOSE command to authorize erasure.
  319.  
  320.  
  321.  
  322.     IF YOU ARE USING THIS PROGRAM AND FIND IT OF VALUE, YOUR
  323.     CONTRIBUTION ($35 SUGGESTED) WILL BE APPRECIATED !
  324.  
  325.  
  326.     STEVE O'KANE                          RON SIMMONS
  327.     4306 DIEHL WAY            OR          4303 ALCOSTA PLACE
  328.         PITTSBURG, CA. 94565                    PITTSBURG, CA 94565
  329.     415-544-6204                   415-427-4381
  330. 
  331.  
  332.     4303 ALCOSTA PLACE
  333.         P